メインコンテンツまでスキップ

SCSL 에러코드

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

1. 에러코드 구분

구분
성공0
일반 오류-1
서버 설정 및 동작 관련 오류-1000~
서버 통신 관련 오류-2000~
키 파일 오퍼레이션 관련 경고/오류-3000~
키 파일 관련 정보 경고-4000~
키 파일 개수 오류-5000~
UID 오류-6000~
키 파일 Verify 오류-7000~
File 관련 오류1000 ~
Parameter 관련 오류2000 ~
KeyFile 관련 오류3000 ~
Algorithm 관련 오류4000 ~
Property 관련 오류5000 ~
Policy 관련 오류6000 ~

2. 에러코드 상세

<Tabs defaultValue="3000~" values={[ {label: '1~ ', value: '1~'}, {label: '1000~', value: '1000~'}, {label: '2000~', value: '2000~'}, {label: '3000~', value: '3000~'}, {label: '4000~', value: '4000~'}, {label: '5000~', value: '5000~'}, {label: '6000~', value: '6000~'}, {label: '7000~', value: '7000~'}, ]}

코드선언설명적용모듈해결방법
1RETVAL_FAIL키 정보 오류일 경우JAVA,DLL
-1ERROR_FAIL_CODE파라미터가 NULL 일 경우DLL사용 하지 않음
-11ERROR_MEM_ALOCATE메모리 할당 에러DLL사용 하지 않음
-12ERROR_MEM_ACCESS메모리 접근 에러JAVA, DLL
-21ERROR_SECU_ALG암호화 알고리즘 에러DLL
-22ERROR_SECU_KEY암호화 키에 관련된 에러사용 하지 않음
-26ERROR_GET_ACLACL을 얻어오지 못하는 에러사용 하지 않음
-27ERROR_RIGHT_ACL올바른 ACL 이 아닐 때 에러사용 하지 않음
-31ERROR_FILE_EXIST원본 파일이 존재 하지 않음JAVA, DLL
-32ERROR_FILE_CREATE파일 생성 에러DLL
-33ERROR_FILE_ACCESS파일 접근 에러JAVA, DLL
-36ERROR_FILE_NOTENCRYPTED원본 파일이 암호화 파일이 아님JAVA, DLL
-41ERROR_FILE_DAMAGED사용 하지 않음
-51NO_SCDSFILE_ACCESS사용 하지 않음
-61ERROR_EXCEPTIONEXCEPTION 에러JAVA
-62ERROR_FILESIZE_ZERO원본 파일 사이즈가 0사용 하지 않음
-71ERROR_EXT_IMPOSSIBLE지원하지 않는 확장자JAVA, DLL
-72ERROR_USER_NOT_FOUND입력 받은 유저 ID를 키파일에서 찾을 수 없을 경우JAVA, DLL
-73ERROR_LOG_FAIL로그 생성 실패사용 하지 않음
-75ERROR_INDEXINFOIndex 검색 중 관련 에러JAVA등급 암호화에서 사용
-76ERROR_NOT_DEFINE_INDEXINFO정의되지 않는 Index 사용JAVA등급 암호화에서 사용
-81RETVAL_BYPASSBYPASS 모드인 경우JAVA
-91ERROR_STREAM_SIZE_ZERO사용하지 않음
-92STREAM_NOTENCRYPTED사용하지 않음
</TabItem>
|값|코드선언|설명|적용모듈|해결방법|
|---|---|---|---|---|
|1000|NO_SOURCE_FILE_EXISTS|원본 파일이 없음|JAVA||
|1001|SOURCE_FILESIZE_ZERO|원본 파일의 크기가 0|JAVA||
|1002|UNKNOWN_TYPE_OF_FILE|암호화 파일의 방식을 알 수 없음|JAVA, DLL||
|1003|ENCFILE_SIZE_FAIL|암호화 파일 크기 오류|JAVA, DLL|사용하지 않음|
|1004|ENCFILE_IS_NOT_DAC|암호화 파일이 DAC이 아님|JAVA, DLL||
|1005|ENCFIEL_IS_NOT_MAC|암호화 파일이 MAC이 아님|JAVA, DLL||
|1006|ENCFILE_IS_NOT_GRADE|암호화 파일이 GRADE가 아님|JAVA, DLL||
|1010|ERROR_ENCFILE_HASH_VALUE|암호화 파일 헤더의 Hash Value 다름|JAVA, DLL||
|1020|NO_MATCH_HEADER_KEY|헤더 복호화 실패|JAVA, DLL||
|1030|NOT_CREATE_DESTINATION_FILE|암호화 or 복호화 파일 생성 실패|JAVA||
|값|코드선언|설명|적용모듈|해결방법| |---|---|---|---|---| |2000|NULL_PARAMETER|파라미터가 NULL|JAVA|| |2001|INVALID_PARAMETER|파라미터가 유효하지 않음|JAVA, DLL|| |2002|SAME_FILEPATH|원본 파일과 대상 파일의 경로가 같음|JAVA, DLL|| |2010|INVALID_AUTHINFO|권한 정보 오류|JAVA, DLL|Client에서 넘겨진 권한 정보가 암호화 파일의 권한 정보와 다름| |값|코드선언|설명|적용모듈|해결방법| |---|---|---|---|---| |3000|NO_KEYFILE_EXISTS|키 파일이 없음|JAVA, DLL|시스템 소스(설정)에서 Keyfile 선언한 위치 확인 | |3001|NO_SEARCH_IDs_KEY|키 파일에 사용자 ID가 없음|JAVA, DLL|1. 신규사용자가 생성한 문서이지만 키파일이 갱신이 안된경우
2. 암/복호화시 선언한 ID가 Keyfile에 없는 경우| |3002|MAKE_DOCUMENT_KEY_FAIL|문서 암호화 키 생성 실패|JAVA, DLL|| |3003|NOT_FOUND_KEYFILE|서버 ID에 해당하는 키 파일을 찾을 수 없음|JAVA, DLL|타사 또는 다른 서버에서 생선한 문서인지 확인| |3010|DIFFERENT_TYPE_OF_KEYFILE|키 파일의 타입이 다름|JAVA, DLL|| |3011|KEYFILE_IS_NOT_DAC|키 파일이 DAC 이 아님|JAVA|| |3012|KEYFILE_IS_NOT_MAC|키 파일이 MAC 이 아님|JAVA|| |3013|KEYFILE_IS_NOT_GRADE|키 파일이 GRADE 가 아님|JAVA|| |3014|UNKNOWN_TYPE_OF_KEYFILE|키 파일의 타입을 알 수 없음|JAVA, DLL|| |3020|KEYFILE_PARSING_FAIL|키 파일 파싱 실패|JAVA, DLL|| |3021|KEYFILE_HEADER_INFO_FAIL|키 파일의 헤더 정보가 틀림|JAVA, DLL|| |3022|KEYFILE_SIZE_FAIL|키 파일의 크기 오류|JAVA, DLL|| |3030|NOT_AUTHENTICATION_KEYFILE|인증되지 않은 키 파일|JAVA, DLL|1. 선언한 서비스ID가 인증이 안된경우
2. 시스템시간이 문서보안서버와 2시간이상 차이나는경우
3. hostname또는 IP가 변경된 경우 | |3031|NOT_SUPPORT_KEYFILE_V3|버전 2 또는 3 키 파일 지원하지 않음|JAVA, DLL|| |3032|INVALID_SERVICE_ID|서비스 ID가 다름|JAVA|3030에서 상세코드로 분리 표시 설명대로 확인| |3033|INVALID_KEYFILE_TIME|키파일 사용 유효기간이 경과됨|JAVA|3030에서 상세코드로 분리 표시 설명대로 확인| |3034|INVALID_SYSTEM_TIME|시스템 시간이 키파일 생성시간과 다름|JAVA|3030에서 상세코드로 분리 표시 설명대로 확인| |3040|KEYFILE_DECRYPT_FAIL|키 파일 복호화 실패|JAVA|3030에서 상세코드로 분리 표시 설명대로 확인| |3050|NOT_SUPPORT_ALGORITHM|키 파일이 알고리즘에 사용되는 키 정보를 가지고 있지 않음|JAVA, DLL|3030에서 상세코드로 분리 표시 설명대로 확인|
|값|코드선언|설명|적용모듈|해결방법| |---|---|---|---|---| |4001|DECRYPT_FAIL|복호화 실패|JAVA|| |4010|NO_SUCH_ALGORITHM|암호화 알고리즘을 찾을 수 없음|JAVA, DLL|| |4020|INVALID_KEY|지정된 키로 초기화를 할 수 없음|JAVA, DLL|DS_CUSTOM_HEADER_KEY, DS_KEY_ENCRYPTION_KEY 정책을 SECURITYDOMAIN(최상위) 그룹에 적용 후 키매니저 재시작| |4030|INVALID_ARGUMENT|부 적절한 인자|JAVA, DLL|| |4040|ERROR_ALGORITHM|블록/패딩 암호화/복호화 오류|JAVA, DLL|| |값|코드선언|설명|적용모듈|해결방법| |---|---|---|---|---| |5010|NOT_SECURE_PROPERTY_FILE|보안 설정 파일이 아님|JAVA, DLL|보안 설정 파일 강제 적용 시| |5020|PROPERTY_FILE_DECRYPT_FAIL|보안 설정 파일 복호화 실패|JAVA, DLL|| |값|코드선언|설명|적용모듈|해결방법| |---|---|---|---|---| |6000|EXCEPT_DECRYPT_ID|복호화 불가 문서 ID|JAVA, DLL|복호화 정책으로 적용 시| |6001|NOT_ALLOW_READ_AUTH|복호화 불가 읽기 권한|JAVA, DLL|복호화 정책으로 적용 시| |6003|NOT_ALLOW_EDIT_AUTH|복호화 불가 편집 권한|JAVA, DLL|복호화 정책으로 적용 시| |6010|NOT_ALLOW_SERVER_ID|복호화 불가 Server ID|DLL|설정 파일에 Server ID 목록 설정 시| |값|코드선언|설명|적용모듈|해결방법| |---|---|---|---|---| |7001|SOCKET_CONNECTION_FAIL|KMS 소켓 연결 상태 실채|JAVA|| |7002|SOCKET_BUFFER_OVER_FLOW|Buffer over flow|JAVA|| |7003|SOCKET_POOL_INIT_FAIL|Socket Pool 초기화 실패|JAVA|| |7004|DATA_NULL|통신 데이터 값이 null|JAVA|| |7005|DATA_PARSING_FAIL|통신 데이터의 Object가 파싱 실패|JAVA|| |7006|NOT_EXIST_KEY_FILE|존재하지 않는 키 파일 요청시|JAVA| / 실제 표시 에러코는 3000| |7007|UNUSUAL_CONNECTION|Prifix 값이 없는 알 수 없는 통신으로 인한 실패|JAVA||